# Group Configuration
Defines SharePoint groups to be created on a site collection with members and membership options.
Referenced by: SiteCollectionCfg.GroupSet.
# Overview
GroupCfg defines SharePoint groups and their members. Groups are created at the site collection level and can be referenced in permission sets or used for access management.
Nested configurations:
GroupItem (list)— individual group definitions with membership
# Applied when
SharePoint groups are created when:
- The parent
SiteCollectionCfgis provisioned and references this configuration viaGroupSet - Applied during site collection provisioning; groups are created after the site collection is created
- All members defined in the
Groups (list)array are assigned to their respective groups - Retroactive changes to group membership require manual SharePoint administration or re-provisioning
# Core settings
# Name
Type: string | Required: Yes
Unique name for this group configuration. Referenced from SiteCollectionCfg.GroupSet.
Example: "MatterOwners", "Clients"
# Groups
Type: GroupItem (list) | Required: Yes
Array of group definitions. See Group definition section below.
# Group definition (within Groups (list))
# Name
Type: string | Required: Yes
Display name of the group (shown in the SharePoint UI and group lists).
Example: "Matter Owners", "All Clients"
# Description
Type: string | Required: No
Group description. Shown in SharePoint group settings.
# Owner
Type: string | Required: Yes
Owner of the group (login name). The group owner has administrative control over the group.
Example: "john.smith@company.com"
# Members
Type: string (list) | Required: No
Array of member login names to add initially. Specify as email addresses or login names.
Example: ["user1@company.com", "user2@company.com"]
Note: Use either Members or Url, not both.
# Url
Type: string | Required: No | Configurator: "Template Url"
Template URL to copy members from (alternative to manual Members array). When specified, members are copied from the SharePoint group at this URL.
Example: "/sites/template/ or another site URL.
Note: Use either Members or Url, not both.
# AllowMembersEditMembership
Type: bool | Required: No
Allow members to edit group membership. When enabled, group members can add or remove other members.
# OnlyAllowMembersViewMembership
Type: bool | Required: No
Restrict member visibility to group members only. When enabled, only members of the group can see who else is in the group.
# RemoveMembersIfNotDefined
Type: bool | Required: No | Default: true
Remove members not in the configuration. When enabled, members not listed in Members are removed during provisioning. When disabled, members are retained.
# AlwaysUpdateMembers
Type: bool | Required: No | Default: true
Always update members even when the group exists. When enabled, membership is updated every provisioning run. When disabled, members are only added during initial group creation.
# Related
- Permission Set Configuration — reference groups in role assignments
- Site Collection Configuration — parent collection where groups are created